Skip to content

docs(website): allow release-line snapshot refresh#461

Merged
dc-tec merged 1 commit into
mainfrom
fix/docs-refresh-version-labels
May 19, 2026
Merged

docs(website): allow release-line snapshot refresh#461
dc-tec merged 1 commit into
mainfrom
fix/docs-refresh-version-labels

Conversation

@dc-tec

@dc-tec dc-tec commented May 19, 2026

Copy link
Copy Markdown
Owner

Summary

Fixes the release-line docs refresh command added in #458. During refresh, the script temporarily removes the target version from website/versions.json before rebuilding it. The Docusaurus config was still hard-coding labels for 0.2.0 and 0.1.0, so Docusaurus could reject that transient state as an unknown version.

The config now reads website/versions.json and only applies release-line labels for versions that are currently present.

Related Issues

Follow-up to #458.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactor (code improvement/cleanup)
  • CI, release, or build tooling
  • Other maintenance

Risk and Compatibility

Low risk. Public docs routes and labels remain unchanged during normal builds. This only makes the config tolerate the temporary versions.json state used by docs-refresh-version.

Verification

  • npm --prefix website run typecheck
  • temp-tree execution of website/scripts/refresh-version.mjs 0.2.0, verifying versions.json order stays 0.2.0,0.1.0
  • npm --prefix website run build
  • git diff --check
  • pre-push make lint-ci

Reviewer Notes

This same fix is already included in the release-0.2 backport PR #460 because the bug was found while validating that branch.

Checklist

  • My code follows the project style guide.
  • I have performed a self-review of my own code.
  • I have added or updated tests, or explained why tests are not needed.
  • I have updated documentation, or explained why docs are not needed.
  • I have updated generated artifacts, or confirmed none are affected.
  • I have checked that this change does not log or expose secrets, tokens, credentials, keys, or raw Secret data.
  • I have run the relevant local checks, or documented why they were not run.
  • Any dependent changes have been merged, published, or clearly called out.

Signed-off-by: Roel de Cort <roel.decort@adfinis.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation size/S labels May 19, 2026
@dc-tec dc-tec self-assigned this May 19, 2026
@dc-tec dc-tec marked this pull request as ready for review May 19, 2026 12:51
@dc-tec dc-tec changed the title fix(docs): allow release-line snapshot refresh docs(website): allow release-line snapshot refresh May 19, 2026
@dc-tec dc-tec merged commit 0d3ff52 into main May 19, 2026
43 checks passed
@dc-tec dc-tec deleted the fix/docs-refresh-version-labels branch May 19, 2026 12:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant